home *** CD-ROM | disk | FTP | other *** search
/ Netscape Plug-Ins Developer's Kit / Netscape_Plug-Ins_Developers_Kit.iso / CGIPERL / MACPERL / MSRCE418.HQX / Perl Source ƒ / README.MPW < prev    next >
Encoding:
Text File  |  1995-02-20  |  14.2 KB  |  316 lines
  1. WELCOME TO MPW PERL
  2.  
  3. This is Perl for the Mac, ported to MPW C by Matthias Neeracher 
  4. <neeri@iis.ee.ethz.ch> and Tim Endres <time@ice.com>. It runs every program in 
  5. the test suite that you could it reasonably expect to, and some you probably 
  6. didn't expect. Feel free to give this program away according to the terms stated 
  7. in the README file.
  8.  
  9. System Requirements
  10.  
  11. The MPW tool probably runs under System 6 and 7, although only System 7 has been
  12. tested by me lately. The standalone application requires System 7, but "MacPerl
  13. Runtime" provides a decent subset of the functionality under System 6. Some of 
  14. the really cool features require ToolServer, System 7, and enough RAM (Notably
  15. stuff like `CFront MacApp.cp`, while (<┼.c>) or open(XXX, "Catenate ┼.c |"))
  16. Some of the files barely compile with 5 megabytes of RAM. MPW C 3.3.1 is the 
  17. latest version of MPW C that has been used for rebuilding this release of Perl.
  18.  
  19. Bugs, Suggestions, Damnations
  20.  
  21. Please send your bug reports and/or fixes to <neeri@iis.ee.ethz.ch> (It is rather 
  22. unlikely that any of the bugs are relevant to the UNIX version). Note that MPW 
  23. Perl is neither developed nor supported by Apple Computer, Inc.
  24.  
  25. Mailing list
  26.  
  27. There is now a mailing list for announcing new releases, sharing scripts, and 
  28. discussions about how to make MPW Perl change your life. To subscribe, send
  29. a mail to <mpw-perl-request@iis.ee.ethz.ch>
  30.  
  31. Ftp sites
  32.  
  33. If you have internet access, you can obtain the newest versions of Perl by 
  34. anonymous ftp from one of the following addresses:
  35.  
  36. nic.switch.ch [130.59.1.40]       software/mac/perl
  37. ftp.eunet.ch  [146.228.10.15]     software/mac/perl
  38.  
  39. Revision History
  40.  
  41. 19Feb95    4.1.8
  42.  
  43. - `hostname` is now hardcoded to Do The Right Thing.
  44. - Changed the behaviour of batch mode: No input is accepted beyond
  45.   what is in the DoScript AppleEvent.
  46.   
  47. 31Jan95    4.1.7
  48.  
  49. - Saving as System 7 Runtime would crash PowerMacs. Now it doesn't, but it may
  50.   produce fat runtimes up to 1.5M in size [Hannu Strang].
  51.  
  52. 23Jan95    4.1.6
  53.  
  54. - The TFileSpec constructor taking working directories was broken, which in
  55.   turn resulted in wrong directories for choose() [Barry Eynon].
  56.   
  57. 08Jan95    4.1.5
  58.  
  59. - Under some circumstances, MacHTTP CGI Scripts would crash on PowerPC
  60.   [C. Joe Holmes, Charles Albrecht].
  61. - Fixed a bug in XL callbacks [Shimizu Shu].
  62. - MacPerl would write to address 0 on the second and following scripts
  63.   [Peter Lewis].
  64.  
  65. 31Dec94    4.1.4
  66.  
  67. 27Dec94    4.1.4b8
  68.  
  69. - 4.1.4b7 had a disastrous floating point bug [Kevin Altis].
  70.  
  71. 27Dec94    4.1.4b7
  72.  
  73. [Some of these were already fixed in previous betas]
  74. - `` now returns both stdout and stderr, like on Un*x perl [Gus Fernandez].
  75. - $? now returns a nonzero value on errors [Gus Fernandez].
  76. - &MacPerl'GetFileInfo now returns undef (instead of garbage) when called
  77.   on folders or nonexistent files.
  78. - times() works now [Hal Wine].
  79. - MacPerl tries to fail more gracefully on deep recursions [Forrest Whitcher].
  80. - Added &MacPerl'Volumes() which returns all mounted volumes.
  81. - Saving a console window would cause its name to change [Tom Pollard].
  82. - Typing into a read only window would send them to another window [Alun Carr].
  83. - DoScript AppleEvents return a success/failure indication and scripts
  84.   started from within the application pop up the error location [Tom Pollard].
  85. - MacPerl'Quit(2) would quit without offering to save changes [Hal Wine].
  86.   Furthermore, a new value Quit(3) now causes the application to try quitting
  87.   if the currently ran script was the first to run after startup.
  88. - srand(time) didn't [Omar Souka].
  89. - Plausibility checking for window areas was not always sufficient [Peter Lewis].
  90. - open("|-") is now caught early and a more accurate diagnostic message is given.
  91. - The feet of the camel cursor used to run backwards [Tom Pollard].
  92. - MacPerl would consider "" in numeric context a NaN [Henry Churchyard].
  93.  
  94. 16Dec94    4.1.4b6
  95.  
  96. - Crash reports have practically ceased. Unless new problems turn up, all that
  97.   will change until the release will be the list of credits and the version numbers.
  98. - Balloon help for Perl operators was broken on the PowerPC [Sandra Silcot].
  99. - Editing running MacHTTP CGIs would leave temporary files in rather 
  100.   obvious places. They are now moved to the temporary folder
  101.   [Thorsten von Eicken].
  102.   
  103. 03Dec94    4.1.4b5
  104.  
  105. - I currently have a major problem in that lots of people seem to experience
  106.   hard-to reproduce crashes. Please keep those crash reports coming!
  107. - Running two subsequent scripts using chop() would crash 
  108.   [Tom Pollard, Bill Moore, Joaquim Baptista, Sandra Silcot].
  109. - Implemented a "Jump" command in the Edit menu.
  110. - Added balloon help in several places. Peter Lewis' Balloon2Rez script
  111.   actually makes this fun!
  112.  
  113. 16Nov94    4.1.4b4
  114.  
  115. - The PowerPC version crashed on all Macs that didn't have StdCLibInit.
  116. - Update and Activate events would get lost on ToolServer launches.
  117. - Combining Application and MPW Tool was widely unpopular. This version
  118.   releases them separately again.
  119.  
  120. 07Nov94    4.1.4b3
  121.  
  122. - This beta adds PowerPC support.
  123. - AppleScript should record somewhat nicer code. Furthermore, some loose 
  124.   ends in scripting support were tied ("the clipboard" works now) [Mike West].
  125. - MacPerl should now be fully manipulatable from another application, though
  126.   it will still take the TCL skills of Tom Pollard to bring that potential
  127.   to life [Tom Pollard, Pete Keleher].
  128. - The droplet glue code was moved into a separate and much more general
  129.   "package" feature. See MacPerl.Frontend for more about the last two items.
  130. - Added chmod [John Kamp].
  131. - Added a little more XCMD glue, so CommConnect will now let you access the
  132.   serial port.
  133. - Added CommConnect.pl and FileCopy.pl, see their corresponding tests in
  134.   :t:mac: for examples how to use them.
  135. - More details to follow.
  136.  
  137. 04May94    4.1.3
  138.  
  139. 25Apr94    4.1.3b3
  140.  
  141. - implemented utime() as far as possible (i.e., for modification times, the
  142.   Mac has no concept of access times) [James Burgess].
  143. - Pressing Control when launching a droplet enters the Perl debugger.
  144. - Introduced a preference option for inline input vs. floating input windows
  145.   for Japanese input.
  146. - Introduced a built-in variable $MacPerl'Version containing a string 
  147.   "4.1.3b3 MPW" or "4.1.3b3 Application", respectively.
  148. - Attempting to write on half open sockets would still sometimes hang 
  149.   [Asa Packer].
  150. - Permissions returned by stat() for locked files were wrong [John Kamp].
  151. - rename() on aliases renamed the original, not the alias 
  152.   [Maki Watanabe, Man Wei Tam].
  153. - gethostbyname() in scalar context would hang or return nonsense [Asa Packer].
  154.   This bug even appears in Unix Perl.
  155. - read() and recv() wouldn't work on stream sockets [James Burgess, Asa Packer].
  156. - Under certain conditions, malloc() would allocate memory in a pathological way
  157.   [Jim Kateley, Gary LaVoy, Barry Wolman]
  158. - While I was fixing the following, I rewrote malloc() for small blocks, which
  159.   appears to improve performance of the application considerably.
  160. - The font list in the format dialog now scrolls to make the default font visible
  161.   and draws font names in the correct *script system* (I don't believe in drawing 
  162.   fonts in their own font).
  163. - (Hopefully) fixed the timelocal.pl library.
  164. - Deleting all text in a console window would disable further input 
  165.   [Jim Kateley].
  166. - The cursor would not always revert to an arrow at the end of a script 
  167.   [Jim Kateley].
  168. - Added support for inline input for Japanese. This is supposed to work if
  169.   a system extension "Inline Tuika Kinou" is present. 
  170. - Avoid interrupting Perl scripts in the middle of asynchronous calls. Now, it 
  171.   should first interrupt the call, and wait with killing the script until a safe 
  172.   state is reached. This might fix a few nonspecific bugs.
  173. - Changed segmentation strategy and preloaded all segments which should fix a 
  174.   crash occuring when a window was dragged while a droplet ran 
  175.   [Michael Greenspon].
  176. - The sleep strategy still was a disaster (among others, performance was bad, and
  177.   TCP transfers would stop when Perl was in the background  
  178.   [Man Wei Tam, Michael Greenspon et al.]
  179. - getservbyname would fail unless /etc/services was in the preferences folder
  180.   [Alasdair Rawsthorne]
  181. - gmtime should work now, provided you either live in Greenwich or set your 
  182.   location in the Map control panel correctly [reported long ago by Roger Linder]
  183. - If any Perl script in a MacPerl session except the first one would try to use
  184.   TCP/IP, utterly nasty crashes would result 
  185.   [Sal Gurnani, Torsten Ekedahl et al.].
  186. - If no #! line was given, error line counts were off [David Friedlander]
  187. - ... and a few more GUSI related bug fixes.
  188.  
  189. 19Jan94    4.1.2
  190.  
  191. - Cursor wouldn't spin anymore [Jim Kateley]
  192. - Droplets didn't accept dropped files [Brad Hanson]
  193. - Opening two copies of MacPerl at the same time would give strange 
  194.   effects [Peter Lewis].
  195.   
  196. 12Jan94    4.1.1
  197.  
  198. - chdir() under some circumstances would not fail when trying to change to 
  199.   a nonexistent directory [Peter Lewis]
  200. - Added StandardFile.pl, originally written by Maki Watanabe.
  201. - Console windows behave better under stress (like when used by 
  202.   GUSIRemoteConsole).
  203. - Adapted semantics of GUSI select() on eof to the Un*x behavior.
  204. - Overwriting a file with a shorter version would sometimes produce trailing
  205.   garbage.
  206. - Supports -i without backup extension now [Reported long ago by Steve Dorner]
  207. - Supports opening up to 64 stdio files or 32 sockets [James Tisdall]
  208. - Fixed handling of default arguments to standard putfile/getfile/getfolder 
  209.   dialogs [Maki Watanabe]
  210. - Get folder dialogs now show the prompt argument given to choose [Maki Watanabe]
  211. - Fixed many aspects about cursor handling in MacPerl 
  212.   [Peter Lewis, Maki Watanabe].
  213. - When opening a script bigger than 32K, you are now offered to save it in any
  214.   format that MacPerl supports, which makes creating big runtimes or droplets
  215.   easier [David N. Blank-Edelman].
  216. - Perl would on startup open all network drivers, causing inconveniences and 
  217.   crashes on machines running SLIP or PPP [Lots of people].
  218. - MacPerl would die ungracefully under System 6.0.x. Now it dies gracefully.
  219. - MacPerl didn't display the list of acknowledgments correctly.
  220. - MacPerl didn't handle the desk scrap correctly [Maki Watanabe].
  221. - Made Perl more robust against out of memory situations [James Tisdall].
  222. - -t in MacPerl would lie for console windows [James Tisdall].
  223. - Cleaned up usage messages for &MacPerl'XXX extensions and in droplets.
  224. - Perl now supports calling many HyperCard XCMDs.
  225. - Added support for faccess() in the MPW Tool [Scott Collins].
  226. - Added a few options to MacPerl's preference dialog [Joe Bearly]. Among 
  227.   others, you can make MacPerl insist on a #! in your scripts.
  228.  
  229. 23Oct93    4.1.0
  230.  
  231. - Unified version for E.T.O. and non-E.T.O. release.
  232. - The standalone application has been completely rewritten and now supports:
  233.   - A separate window for the debugger
  234.   - Built-in support for creating Droplet applications and Runtimes for both
  235.     System 6 and System 7.
  236.   - Online Help, including balloons for all Perl commands.
  237.   - Recordability and scriptability from AppleScript.
  238.   - A cool new suite of icons (don't forget to rebuild the desktop file after 
  239.     installing if you had an old version of MacPerl installed).
  240.   
  241.   I have tried to credit all people who contributed to the development of Perl in
  242.   the About box. If you feel left out, feel free to drop me a note :-)
  243. - Disk based associative arrays are supported again.
  244. - All Mac specific commands are renamed again (maybe this time for good).
  245. - AppleScript is supported through the &MacPerl'DoAppleScript command.
  246.  
  247. 09Apr93    4.0.7Ñ
  248.  
  249. - Cleaned packaging up for E.T.O. release.
  250. - This version currently excludes support for disk based associative arrays. A 
  251.   version which supports them is available by anonymous ftp from the above sites. 
  252.  
  253. 14Mar93    4.0.7
  254.  
  255. - Upgraded to UNIX pathlevel 36
  256. - Added &fgetinfo() and &fsetinfo() (David N. Blank-Edelman suggested these)
  257. - `pwd` or `Directory` (case is important) are hardcoded as a substitute for 
  258.   getcwd().
  259. - find2perl works now, thanks to Charlie Reiman
  260. - The Mac specific Perl routines are discussed in MacPerl.Specifics, as are my
  261.   namespace migration plans (as suggested by numerous people). This file is
  262.   still in a very rough state; suggestions for improvements are welcome.
  263. - The standalone version no longer presents a save dialog before quitting (as 
  264.   suggested by David N. Blank-Edelman).
  265. - Line numbers for extracted scripts (that is, practically all MPW Perl scripts)
  266.   are now presented more honestly. Unfortunately, this currently seems to break
  267.   the "b subroutine" function of the debugger.
  268. - GUSI related changes:
  269.     - Added support for the Printer Access Protocol (PAP): You can open a 
  270.       connection to the currently chosen LaserWriter with open("Dev:Printer").
  271.     - Added support for Dave Peterson's forthcoming inetd.
  272.     - st_nlink in statbufs used to return 1 for both files and folders. While it 
  273.       might be argued that this is true, it breaks some Unix programs. Therefore, 
  274.       the current version returns for folders either the number of items the 
  275.       folder contains + 2 or the number of subdirectories the folder contains + 2 
  276.       (the 2 is an Unixism), depending on a flag in the configuration resource 
  277.       (thanks to Charlie Reiman for reporting).
  278.     - fstat() used to claim that sockets were regular files. This bug had horrible 
  279.      consequences for Perl. Now, it correctly declares sockets to be
  280.      such.
  281.     - PPC sockets might work better now.
  282.  
  283. 24Jan93    4.0.6
  284.  
  285. - choose() for files no longer includes the terminating null character.
  286. - rename() and TCP sockets work better (thanks to Brad Pickering for reporting
  287.   these bugs).
  288. - standalone version can read scripts from its data fork and accepts more 
  289.   startup files.
  290. - (hopefully) improved the documentation a little. Added ObiWan support.
  291.   
  292. 20Dec92    4.0.5
  293.  
  294. - Supports sockets and symbolic links.
  295. - "ask", "answer" and "pick" are now builtins with a slightly changed syntax 
  296.   (sorry).
  297. - A few mac scripts are now provided in :t:mac and :macscripts:
  298. - The application now always searches for a #! line first. If none is found,
  299.   the script is executed anyway, but the file has to be read twice.
  300.   
  301. 27Sep92    4.0.4
  302.  
  303. This release upgrades the Mac version to UNIX patchlevel 35.
  304.  
  305. 08Jun92    4.0.3
  306.  
  307. This release supports opendir (In fact, I thought the last one'd already 
  308. support it. Thanks to Mike Meckler <meckler@egg.gg.caltech.edu> for reporting 
  309. this bug).
  310.  
  311. dbmopen & friends are now supported.
  312.  
  313. 20Jan92    4.0.2
  314.  
  315. First public release.
  316.